Skip to main content

Trading Signal Format

Please follow these rules when sending trading signals.

1. Market Execution Orders (BUY / SELL)​

For BUY and SELL market execution orders, do not include a price field. The order is executed immediately at the current market price.

✅ Buy Now Example​

  pair: "EURUSD",
  type: "BUY",
  sl: 1.16500,
  tp: 1.17500

✅ Sell Now Example​

{
  "pair": "GBPUSD",
  "type": "SELL",
  "sl": 1.27500,
  "tp": 1.26000
}

❌ Incorrect Market Order​

  pair: "EURUSD",
  type: "BUY",
  price: 1.17000,
  sl: 1.16500,
  tp: 1.17500

Reason: Market execution orders should never include a price field.

2. Pending Orders (Price Required)​

If you specify an entry price, the signal must use one of these pending order types:

  • BUY_LIMIT
  • SELL_LIMIT
  • BUY_STOP
  • SELL_STOP

For pending orders, always include:

  • pair
  • type
  • price
  • sl
  • tp

✅ Buy Limit Example​

  pair: "EURUSD",
  type: "BUY_LIMIT",
  price: 1.17000,
  sl: 1.16500,
  tp: 1.18000

✅ Sell Limit Example​

  pair: "GBPUSD",
  type: "SELL_LIMIT",
  price: 1.27500,
  sl: 1.28000,
  tp: 1.26500

✅ Buy Stop Example​

  pair: "XAUUSD",
  type: "BUY_STOP",
  price: 3365.50,
  sl: 3355.50,
  tp: 3385.50

✅ Sell Stop Example​

  pair: "USDJPY",
  type: "SELL_STOP",
  price: 158.200,
  sl: 158.700,
  tp: 157.200

3. Entry Price Ranges​

If a signal specifies an entry price range, TraderPilot uses the first price in the range as the pending order entry price.

Example Signal​

SELL XAUUSD 4152–4142
SL: 4165
TP: 4120

Parsed As​

{
  "pair": "XAUUSD",
  "type": "SELL_LIMIT",
  "price": 4152,
  "sl": 4165,
  "tp": 4120
}

Rules​

  • The system always uses the first price in the range as the pending order entry.
  • SELL 4152–4142 → Creates a SELL_LIMIT at 4152.
  • BUY 4142–4152 → Creates a BUY_LIMIT at 4142.
  • The second price in the range is ignored.
  • The system does not place multiple pending orders.
  • The system does not enter anywhere within the specified price range.

Another Example​

Input

SELL XAUUSD 4152–4142

Parsed As

{
  "pair": "XAUUSD",
  "type": "SELL_LIMIT",
  "price": 4152
}

Not Parsed As

  • ❌ Two pending orders (4152 and 4142)
  • ❌ A market execution order
  • ❌ An order that triggers anywhere between 4152 and 4142

Summary​

Order TypeRequired Fieldsprice Field
BUY / SELLpair, type❌ Not Allowed
BUY_LIMIT / SELL_LIMIT / BUY_STOP / SELL_STOPpair, type, price✅ Required

Quick Rules​

  • ✅ BUY / SELL → Do not include a price field.
  • ✅ BUY_LIMIT / SELL_LIMIT / BUY_STOP / SELL_STOP → price is required.
  • ✅ Entry range (e.g. SELL XAUUSD 4152–4142) → Parsed as a single SELL_LIMIT using the first price (4152).
  • ❌ TraderPilot does not create multiple pending orders from an entry range.
  • ❌ TraderPilot does not execute orders anywhere within the specified range.